home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / eblist21.zip / EBLIST.DOC next >
Text File  |  1991-02-03  |  10KB  |  221 lines
  1.  
  2. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  3.  
  4.                     EBLIST 2.0 -- Copyright 1990 by Ed Bragg
  5.  
  6. :::::::::::::::::::::::::::::: UPDATE HISTORY :::::::::::::::::::::::::::::::
  7.  
  8.    Ver 1.0α - 10/23/90 - Initial ALPHA Release
  9.        1.1α - 10/24/90 - Added Cosmetics to output of the FILELIST.TXT.
  10.                          Displays totals and current location on
  11.                          screen while compiling FILELIST.TXT.  Added
  12.                          totals to the end of the FILELIST.TXT
  13.        1.2ß - 10/28/90 - Moves to Beta (It's Pretty Stable) so it may
  14.                          be distributed to the General Public, but
  15.                          please use with caution and by using it you
  16.                          are required to report any Bugs/Errors.
  17.                        - Added the ability to ABORT safely in the
  18.                          middle, if you want to try something else by
  19.                          pressing the [Esc] Key.
  20.                        - Added the following options:
  21.                          /H - Help Screen
  22.                          /D - Optional GTDIR.BBS
  23.                          /F - Optional Output File
  24.                          /T - Optional Header File
  25.        1.3ß - 11/03/90 - Added the following options:
  26.                          /ON  - Create Online Filelist
  27.                          /OFF - Create Offline Filelist
  28.                          /TON - Optional Online Header File
  29.                          /TOF - Optional Offline Header File
  30.        1.4ß - 11/08/90 - Added the following options:
  31.                          /ZIP  - Create PKZIP Archive of FILELIST
  32.                          /ARC  - Create PKARC Archive of FILELIST
  33.                          /LZH  - Create LHARC Archive of FILELIST
  34.                          /PAK  - Create PAK Archive of FILELIST
  35.                          /PKP  - Create PKPAK Archive of FILELIST
  36.                          /ZOO  - Create ZOO Archive of FILELIST
  37.                          /MAIL - Copy Archived File to \MAILIN\FILEIN
  38.                                  Directory.
  39.        1.5ß - 11/18/90 - Added the following options:
  40.                          /CONFIG - Ability to configure EBLIST Defaults
  41.                          Added Code to strip the [, ], $, and ^
  42.                          characters from the GTDIR.BBS file.
  43.        2.0  - 12/08/90 - Official PUBLIC Release
  44.                          If the Header files don't exist in the GTPATH
  45.                          directory, EBLIST will use it's own CANNED
  46.                          Headers. Fixed NULL Pointer problems when
  47.                          certain files were trying to be accessed and
  48.                          they didn't exist.
  49.        2.1  - 02/03/91 - Bug Fix.  I can't believe nobody noticed it
  50.                          during the BetaTesting, but there was a major
  51.                          problem with OFFLINE and ONLINE filelistings.
  52.                          this was reported by Vincent Benoit. <Thanks>
  53.  
  54. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  55.                                      -1-
  56.  
  57. :::::::::::::::::::::: THANKS BETA TESTERS/DISTRIBUTION :::::::::::::::::::::
  58.  
  59.    The Following Sysops are Beta Testers for EBLIST.  New Versions of
  60.    EBLIST may be picked up from these Systems.
  61.  
  62.    As Always the Latest Version will always be available on my Board
  63.    in from the \MAILOUT\FILEOUT Directory (As File EBLIST*.ZIP), or
  64.    the EBWare File Area.  If you File Request FR037000.ZIP from my
  65.    system it will return the filelist of the MAILOUT\FILEOUT directory
  66.    so you can see what I have available for File Request.
  67.  
  68. 004/005 214-279-2153 96 Dallas        *Boardwalk             April Strong
  69. 004/014 214-680-8119 96 Dallas        *E-Link                Kevin Martin
  70. 048/001 804-357-0357 96 Smithfield    *CLUB PC               Jim Kreyling
  71. 071/001 615-353-0514 96 Nashville_TN  +Control Systems       Ed Cavender
  72. 079/000 612-474-0724 96 Minneapolis   +Haven Of Rest         Bryan Pike
  73.  
  74. ::::::::::::::::::::::::::::::: CONTACTING ME :::::::::::::::::::::::::::::::
  75.  
  76.    Ed Bragg                                        BBS Phone: 808-488-7140
  77.    Psc 2 Box 2837                                 The Programmers Exchange
  78.    Honolulu, Hi 96853 (USA)                      GT-Power Net/Node 037/000
  79.  
  80. ::::::::::::::::::::::::::::::::: COPYRIGHT :::::::::::::::::::::::::::::::::
  81.  
  82.    EBLIST and these DOCS are NOT PUBLIC DOMAIN, The Copyright is held by
  83.    Ed Bragg, and Neither are to be Changed Manipulated in anyway,
  84.    without prior written consent.
  85.  
  86.    If you Notice any Errors, or Mistakes, Please Feel free to let me
  87.    know, and I'll try to fix them as soon as I can (Spelling Or Whatever)
  88.  
  89. :::::::::::::::::::::::::::::::: WHAT IT DOES :::::::::::::::::::::::::::::::
  90.  
  91.   Simply:  EBLIST creates a FILELIST.TXT file containing ALL your
  92.            files.
  93.  
  94.  Exactly:  EBLIST reads the GTDIR.BBS file for the areas.  Then Reads
  95.            each of the paths FILES.BBS files and extracts all the
  96.            files and descriptions.  It will extract Multi-Line
  97.            Descriptions as long as the second and following lines
  98.            have at least 1 space at the beginning of the line.  The
  99.            output is sent to the file FILELIST.TXT.  When the program
  100.            is finished, it closes up all the files and returns you
  101.            back to the original directory. EBLIST will also create
  102.            OFFLINE and ONLINE File listings, as well as ZIP them up
  103.            and put them in the directory and use the archive type of
  104.            your choice.
  105.  
  106.  
  107.  
  108.  
  109. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  110.                                      -2-
  111.  
  112. ::::::::::::::::::::::::::::::: RUNNING EBLIST :::::::::::::::::::::::::::::
  113.  
  114.    EBLIST may be run without any command line parameters if you want
  115.    to use the default options.  All you do is Type the following at
  116.    the DOS Prompt. It May also be Run From ANY Drive or Any Directory
  117.    as long as EBLIST is someplace in your PATH. (You will be returned
  118.    Back to Original Path When It's Complete)
  119.  
  120.    Example: C:\> EBLIST
  121.                  ~~~~~~
  122.    The Following MUST exist in order for EBLIST to Run Though:
  123.  
  124.     * A Valid GTPATH= in your Environment; (IE GTPATH=C:\GT)
  125.  
  126.       NOTE: The GTPATH directory will be used as the default
  127.             directory for all files if FULL Pathnames aren't
  128.             used in the config menu.
  129.  
  130.     * A Valid GTDIR.BBS in your GTPATH Directory
  131.  
  132.       NOTE:  The GTDIR.BBS file is in the standard GT-Power Format.
  133.              See the GT-Power HOST.DOC file for more Information.
  134.  
  135.    When EBLIST is finished there will be a file "FILELIST.TXT" in
  136.    your GTPATH Directory, which you may ZIP up into an ALLFILES.ZIP
  137.    or do whatever you like with it.
  138.  
  139.    If you want to use different Input/Output Filenames, see the
  140.    section on OPTIONS.
  141.  
  142. :::::::::::::::::::::::::::::::::: OPTIONS ::::::::::::::::::::::::::::::::::
  143.  
  144.                EBLIST has the following Options available:
  145.  
  146.            /CONFIG - Configure EBLIST Defaults (Menu Driven)
  147.  
  148.            /H   Help Menu - Display Default Settings
  149.  
  150.            You may specify Full Pathnames, otherwise it defaults to
  151.            the GTPATH Directory.
  152.  
  153.            /D    File with List of Areas   <Default: GTDIR.BBS>
  154.            /F    Output File               <Default: FILELIST.TXT>
  155.            /T    Header Text File          <Default: EBLIST.HEA>
  156.            /ON   Online Listing File       <Default: ONLINE.TXT>
  157.            /OFF  Offline Listing File      <Default: OFFLINE.TXT>
  158.            /TON  Online Header Text File   <Default: ONLINE.HEA>
  159.            /TOF  Offline Header Text File  <Default: OFFLINE.HEA>
  160.            /MAIL Copy Archived File to \MAILIN\FILEIN Directory.
  161.  
  162.                                     [Cont]
  163.  
  164. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  165.                                      -3-
  166.  
  167. ::::::::::::::::::::::::::::: OPTIONS [Cont] ::::::::::::::::::::::::::::::::
  168.  
  169.            Archive Options:
  170.  
  171.            /ZIP  Create PKZIP Archive      /PAK  Create PAK Archive
  172.            /ARC  Create PKARC Archive      /PKP  Create PKPAK Archive
  173.            /LZH  Create LHARC Archive      /ZOO  Create ZOO Archive
  174.  
  175.  
  176.   Example #1:  EBLIST             <<---- Just uses the Defaults
  177.  
  178.   Example #2:  EBLIST /Dgtdir.lst /Fd:\bull\newfiles.txt /Theader.txt
  179.  
  180.   Example #3:  EBLIST /ON /OFFd:\bull\15 /TOFofflist.hea
  181.  
  182.   Example #4:  EBLIST /ZIPnet037.000 /MAIL
  183.  
  184. :::::::::::::::::::::::::::::: FUTURE OF EBLIST :::::::::::::::::::::::::::::
  185.  
  186.              The following Options are currently being worked:
  187.  
  188.            /A   Access Levels To Include  <Default: All Levels>
  189.    ??? ->  /I   Inquire (NewFiles)        <Default: All Files>
  190.  
  191. ::::::::::::::::::::::::::::::::: DISCLAIMER ::::::::::::::::::::::::::::::::
  192.  
  193.    Ed Bragg cannot be held responsible for what this program may or
  194.    may not do to your system.  Everything works fine here, and I can
  195.    give no guarantees as to what will or may happen on your system.
  196.  
  197.    Though, I'll try to fix any bug reports (Because I hate for things
  198.    not to work) as soon as possible.
  199.  
  200.    Use this program at your own Risk!
  201.  
  202. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219. :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  220.                                     -END-
  221.